home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / dev / misc / ModemLink1_2.readme < prev    next >
Text File  |  1997-11-02  |  9KB  |  190 lines
  1. Short:    Let's you write Modem Linkable games easier (Oct 13 1997)
  2. Author:   yogi@autobahn.mb.ca (Michael Veroukis)
  3. Uploader: yogi@autobahn.mb.ca (Michael Veroukis)
  4. Version:  36.2 Release 1.2
  5. Type:     dev/misc
  6. Requires: Amiga OS 2.0 or higher
  7.  
  8.  
  9.                                ModemLink Device
  10.                              Mike Veroukis - 1997
  11.  
  12. Introduction:
  13. ~~~~~~~~~~~~
  14.  
  15.   The ModemLink device was written in an attempt to make modem linkable
  16. games easier to write on the Amiga.  We've seen hundreds of games on the
  17. PC with modem play capabilities, but most Amiga games don't provide this
  18. option.  This frustrates many Amiga game players, as everyone knows it's
  19. much more fun to kill your friends then stupid computer-AI people!
  20.  
  21.   It's no secret that most Amiga programmers are not part of some rich
  22. company.  Therefore, it's easy to understand why many developers don't add
  23. modem play to their games.
  24.  
  25.   First of all, you may be adding a few months to development time just for
  26. the modem link part of the game.  For many hobby programmers, they'd rather
  27. just finish the game quickly, and move onto new and exciting things.  The
  28. ModemLink device gives the developer all the code required for a basic
  29. modem playable game, therefore saving on development time.
  30.  
  31.   Another problem is that you'd need two Amigas, with a modem on each, and
  32. preferably two phone lines (although you could always use a null modem as
  33. well).  Not everyone can have this kind of set up.  The ModemLink device
  34. makes it a little easier to develope the modem linkable game, since there's
  35. less to worry about.  You'll still need to test, but it's the sort of thing
  36. a friend with an Amiga and a modem can help out with.  Since the ModemLink
  37. device has been tested, and is known to work, a game developer only needs to
  38. worry about how to interface with the ModemLink device.
  39.  
  40.   Well, this is all very cool and all, but how does it work???  Although I
  41. don't want to get into the finer details of the device, this is a good
  42. place to give a rough description of the thing.
  43.  
  44.   The ModemLink device provides two important functions;  Modem Connectivity
  45. and a Reliable Serial Protocol.  What does this mean???
  46.  
  47.   Modem Connectivity:
  48.   ~~~~~~~~~~~~~~~~~~
  49.  
  50.   The ModemLink device provides standard routines to dial/answer calls.
  51. These routines can be used to easily set up a modem connection.  They have
  52. been designed to be very flexible and provide significant control to the
  53. programmer.
  54.  
  55.   Reliable Serial Protocol:
  56.   ~~~~~~~~~~~~~~~~~~~~~~~~
  57.  
  58.   Once a modem connection is made, data must be sent and received across the
  59. phone line.  One needs to be sure that the data received is correct, and
  60. the data sent has been received.  To do this, some kind of protocol must
  61. be used, which the ModemLink device provides.  Although designed to support
  62. more protocols in the future, it currently only supports a single protocol
  63. based on what is called the Stop And Wait protocol.
  64.  
  65.   Anyway, as you might have guessed, the main point to this entire project
  66. is to make it easier for Amiga programmers to make modem linkable games.  I
  67. offer this package (with source included) free for everyone to use.
  68.  
  69.  
  70. Release History:
  71. ~~~~~~~~~~~~~~~
  72.  
  73. R1.2 V36.2 (Oct 26 1997):
  74.      - ModemLink.device would not create the ModemLink Semaphore which is needed
  75.        to make sure that only one instance of modemlink.device is running for a
  76.        given Unit.  This has been fixed.
  77.  
  78.  
  79. R1.1 V36.1 (Oct 25 1997):
  80.      - SendModemCMD now checks to see if modem is OFF only if issued command is
  81.        never echoed back from modem.  This is to be compatible with newer
  82.        modems which auto power-up when first command is issued.
  83.      - Cleaned up some documentation.
  84.      - Changed the scoptions file so that it now sets PARAMS=BOTH.  It will now
  85.        use both registers AND stack for parameters.
  86.      - Added StormC pragma file in include/StormC_pragmas.
  87.  
  88.  
  89. R1.0 V36.0 (May 10 1997):
  90.      - Initial release
  91.  
  92.  
  93. R0.0 V00.0 (July 4, 1996):
  94.      - Modemlink Project begins
  95.  
  96.  
  97.   - Mike
  98.  
  99.  
  100. ============================= Archive contents =============================
  101.  
  102. Original  Packed Ratio    Date     Time    Name
  103. -------- ------- ----- --------- --------  -------------
  104.    38552    9820 74.5% 20-Oct-97 23:36:28 +ModemLink.doc
  105.      858     342 60.1% 25-Oct-97 11:55:24 +ModemLink.doc.info
  106.    10560    6509 38.3% 26-Oct-97 18:10:06 +modemlink_000.device
  107.    10540    6515 38.1% 26-Oct-97 17:59:46 +modemlink_020.device
  108.    41684   14723 64.6% 26-Oct-97 16:36:24 +ModemLink.guide
  109.      840     323 61.5% 19-Mar-97 23:30:14 +ModemLink.guide.info
  110.      841     501 40.4% 11-Mar-97 22:05:36 +Build.info
  111.     2632    1711 34.9% 04-Jul-96 15:15:16 +Debug
  112.      831     382 54.0% 11-Mar-97 22:05:36 +Debug.info
  113.     2771     840 69.6% 06-Apr-97 10:49:22 +DeviceStuff.c
  114.      600     252 58.0% 11-Mar-97 22:53:16 +DeviceStuff.h
  115.      838     541 35.4% 11-Mar-97 22:05:36 +Edit.info
  116.      842     451 46.4% 11-Mar-97 22:05:36 +Find.info
  117.      122      88 27.8% 26-Oct-97 18:10:30 +SCoptions
  118.     2954     458 84.4% 11-Mar-97 22:05:36 +SCoptions.info
  119.      990     435 56.0% 25-Mar-97 21:13:16 +smakefile
  120.    17400   11053 36.4% 26-Oct-97 18:10:48 +TestML
  121.     4673    1402 69.9% 25-Oct-97 09:33:14 +TestML.c
  122.      835     392 53.0% 11-Mar-97 22:05:36 +TestML.info
  123.    10584    6625 37.4% 26-Oct-97 18:11:00 +TestMLDev
  124.     5251    1533 70.8% 25-Oct-97 09:33:12 +TestMLDev.c
  125.      835     395 52.6% 11-Mar-97 22:05:36 +TestMLDev.info
  126.      632     283 55.2% 16-Mar-97 15:24:52 +clib.info
  127.     2712     881 67.5% 06-Apr-97 11:51:50 +ModemLink_protos.h
  128.      840     329 60.8% 25-Oct-97 11:55:56 +ModemLink_protos.h.info
  129.      632     277 56.1% 16-Mar-97 15:23:58 +ModemLink.info
  130.     3765    1534 59.2% 26-Oct-97 17:23:34 +ModemLink.h
  131.      840     326 61.1% 25-Oct-97 11:55:42 +ModemLink.h.info
  132.      632     276 56.3% 16-Mar-97 15:26:04 +pragmas.info
  133.      677     217 67.9% 16-Feb-97 12:05:28 +ModemLinkDev_pragmas.h
  134.      840     326 61.1% 25-Oct-97 11:55:50 +ModemLinkDev_pragmas.h.info
  135.      632     281 55.5% 16-Mar-97 15:25:18 +proto.info
  136.      200     134 33.0% 16-Mar-97 14:42:14 +ModemLink.h
  137.      840     327 61.0% 25-Oct-97 11:56:04 +ModemLink.h.info
  138.      632     282 55.3% 25-Oct-97 11:39:46 +StormC_pragmas.info
  139.     1051     391 62.7% 26-Oct-97 16:30:40 +ModemLinkDev_pragmas.h
  140.      840     326 61.1% 25-Oct-97 11:56:10 +ModemLinkDev_pragmas.h.info
  141.    10688    6138 42.5% 26-Oct-97 18:10:06 +ModemLink_000.lib
  142.    10668    6137 42.4% 26-Oct-97 17:59:46 +ModemLink_020.lib
  143.      456     252 44.7% 26-Oct-97 18:10:06 +ModemLinkDev.lib
  144.      841     500 40.5% 06-Apr-97 12:07:24 +Build.info
  145.     3832    2013 47.4% 24-Oct-97 20:23:58 +CRC.c
  146.       98      94  4.0% 28-Dec-96 13:02:04 +CRC.h
  147.     2632    1711 34.9% 04-Jul-96 15:15:16 +Debug
  148.      831     387 53.4% 06-Apr-97 12:07:24 +Debug.info
  149.        0       0  0.0% 26-Oct-97 18:10:10 +
  150.     3032     968 68.0% 24-Oct-97 20:25:32 +DeviceStuff.c
  151.      600     252 58.0% 13-Mar-97 21:56:10 +DeviceStuff.h
  152.      838     542 35.3% 06-Apr-97 12:07:24 +Edit.info
  153.      842     449 46.6% 06-Apr-97 12:07:24 +Find.info
  154.        0       0  0.0% 26-Oct-97 18:10:10 +
  155.     7519    2178 71.0% 24-Oct-97 20:56:24 +Link.c
  156.     2987    1170 60.8% 22-Oct-97 19:59:54 +Link.h
  157.      827     429 48.1% 24-Oct-97 20:35:24 +LinkDevTags.c
  158.      224     165 26.3% 11-Mar-97 22:41:20 +LinkDevTags.h
  159.      732     385 47.4% 24-Oct-97 20:36:24 +LinkTags.c
  160.      213     156 26.7% 13-Mar-97 20:53:46 +LinkTags.h
  161.     9431    2313 75.4% 24-Oct-97 20:40:18 +Modem.c
  162.     1802     668 62.9% 25-Mar-97 20:35:08 +Modem.h
  163.     1118     466 58.3% 24-Oct-97 20:44:30 +ModemDevTags.c
  164.      386     206 46.6% 11-Mar-97 22:41:34 +ModemDevTags.h
  165.      835     395 52.6% 26-Oct-97 14:45:14 +modemlink.device.info
  166.     1043     495 52.5% 24-Oct-97 21:00:08 +ModemLinkAPI.c
  167.      177     126 28.8% 09-Mar-97 18:37:08 +ModemLinkAPI.h
  168.     2990    1052 64.8% 26-Oct-97 16:33:48 +ModemLinkDev.c
  169.      508     248 51.1% 16-Feb-97 12:00:54 +ModemLinkDev.fd
  170.      677     217 67.9% 11-Mar-97 22:33:48 +ModemLinkDev_pragmas.h
  171.     2869     790 72.4% 24-Oct-97 20:52:30 +ModemLinkDevAPI.c
  172.      521     262 49.7% 25-Mar-97 21:09:52 +ModemLinkDevAPI.h
  173.    14317    3308 76.8% 24-Oct-97 20:54:22 +ModemLinkTask.c
  174.      681     354 48.0% 26-Jan-97 15:59:42 +ModemLinkTask.h
  175.     1042     433 58.4% 24-Oct-97 20:44:28 +ModemTags.c
  176.      378     202 46.5% 13-Mar-97 20:53:58 +ModemTags.h
  177.      186     115 38.1% 26-Oct-97 18:00:00 +SCoptions
  178.     2954     455 84.5% 06-Apr-97 12:07:24 +SCoptions.info
  179.     4768    1256 73.6% 26-Oct-97 16:30:02 +smakefile
  180.      628     266 57.6% 25-Mar-97 21:17:54  ModemLink.info
  181.      632     279 55.8% 25-Mar-97 21:17:54 +AutoDocs.info
  182.      632     284 55.0% 25-Mar-97 21:17:54 +Devs.info
  183.      632     283 55.2% 25-Mar-97 21:22:32 +Docs.info
  184.      632     283 55.2% 25-Mar-97 21:17:54 +Examples.info
  185.      632     276 56.3% 25-Oct-97 11:39:14 +include.info
  186.      632     280 55.6% 25-Mar-97 21:17:54 +lib.info
  187.      632     277 56.1% 25-Oct-97 11:38:54 +Source.info
  188. -------- ------- ----- --------- --------
  189.   271393  110996 59.1% 27-Oct-97 04:26:24   84 files
  190.